home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / ams__l~1.zoo / man / terminat.man < prev    next >
Encoding:
Text File  |  1993-09-05  |  1.9 KB  |  60 lines
  1.                         ATARI MACHINE SPECIFIC LIBRARY
  2.  
  3.  
  4.  
  5. NAME
  6.      Termination - taking control of hardware termination
  7.  
  8. SYNOPSIS
  9.      #include <Termination.h>
  10.  
  11.      void TrapExceptions(bool on)
  12.  
  13. DESCRIPTION
  14.      Fiddling with graphics, colours, mouse vectors, etc. can leave the
  15.      computer in a bad state if you don't clean up properly.  So we should
  16.      always clean up... but what about while we are developing software and
  17.      we get a bomb?  This module supports clean up for this case.
  18.  
  19. FUNCTIONS
  20.      void TrapExceptions(bool on)
  21.        on=TRUE  -> Trap all exceptions.
  22.        on=FALSE -> Just let it bomb (default).
  23.  
  24. EXAMPLES
  25.      The AMS Library already uses this facility so that even with a crash:
  26.       - The Screen display and colours are restored
  27.       - The Resolution is restored
  28.       - Mouse and joysticks are restored (ie. mouse is enabled)
  29.       - The Timer A is halted
  30.  
  31. SEE ALSO
  32.      signal.h
  33.  
  34. DIAGNOSTICS
  35.      The return value of a program that crashes and recovers because of
  36.      the features of this module will exit with a return value equal to
  37.      the signal number of the exception.
  38.  
  39. BUGS
  40.      This module uses very low-level code to handle hardware exceptions
  41.      that may not be valid on machines other than the ST.  But if it
  42.      works on the TT, then use it - it's better than leaving the machine
  43.      with the screen Physbase not equal to Logbase!  It should perhaps
  44.      not be used in a production release - but that shouldn't bomb!
  45.  
  46. AUTHOR
  47.      Warwick Allison, 1992.
  48.      warwick@cs.uq.oz.au
  49.  
  50. COPYING
  51.      This functionality is part of the Atari Machine Specific Library,
  52.      and is Copyright 1992 by Warwick W. Allison.
  53.  
  54.      The Atari Machine Specific Library is free and protected under the
  55.      GNU Library General Public License.
  56.  
  57.      You are free to copy and modify these sources, provided you acknowledge
  58.      the origin by retaining this notice, and adhere to the conditions
  59.      described in the GNU LGPL.
  60.